############################################################################################################################
# README File ##############################################################################################################
# "The Incumbency Advantage in Judicial Elections: Evidence from Partisan Trial Court Elections in Six U.S. States #########
# By Michael P. Olson and Andrew R. Stone ##################################################################################
############################################################################################################################

############################################################################################################################
# Description and Instructions #############################################################################################
############################################################################################################################

	This file describes the dataset and script that can be used to replicate results for "The Incumbency Advantage in
	Judicial Elections" by Olson and Stone. The replication package consists of a single dataset in CSV format 
        ("olson_stone_replication_data.csv") and a single R script ("olson_stone_replication.R"). To replicate the results 
        in the paper, replicators should change the working directory at the top of "olson_stone_replication.R" to the 
	directory in which they have saved "olson_stone_replication_data.csv," install any R packages that are loaded at 
        the top of the script that they do not already have installed (specific package versions used for original analysis 
        noted below) and run the script. The figures and tables that are included both in the text of the article and the 
        supplementary materials will be generated by the script and saved to the user-specified working directory.

############################################################################################################################
# Software #################################################################################################################
############################################################################################################################

	Original analysis was done using R version 4.0.4 ("Lost Library Book") on a Dell PC running Windows 10 Enterprise. 
	
	The following R packages (and versions) were used for the analysis:
	1) rdrobust (version 0.99.9)
	2) rdd (version 0.57)
	3) lfe (version 2.8-5.1)
	4) ggplot2 (version 3.3.3)
	5) multiwayvcov (version 1.2.3)
	6) stargazer (version 5.2.2)
	7) rdlocrand (version 0.7.1)

############################################################################################################################
# Data #####################################################################################################################
############################################################################################################################

	There is one data file, "olson_stone_replication_data.csv." This dataset is an unbalanced panel of court election 
	outcomes, indexed by state, court name, and year. Data was created by processing and binding election results from
	individual states. Replicators interested in the creation of the data should contact the authors directly.
	
############################################################################################################################
# Analysis #################################################################################################################
############################################################################################################################

	There is one script, "olson_stone_replication.R." Replicators must change the working directory at the top of the
	script to match the directory where they have saved the replication data, ensure that the required packages (those
	listed above and loaded at the top of the script) are installed, and then run the script. Figures and latex tables 
	corresponding to those in the text and online appendix for the paper will be saved to the working directory.